.TH std::pmr::polymorphic_allocator::allocate_bytes 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::pmr::polymorphic_allocator::allocate_bytes \- std::pmr::polymorphic_allocator::allocate_bytes

.SH Synopsis
   [[nodiscard]] void* allocate_bytes( std::size_t nbytes,
                                       std::size_t alignment =            \fI(since C++20)\fP
   alignof(std::max_align_t) );

   Allocates nbytes bytes of storage at specified alignment alignment using the
   underlying memory resource. Equivalent to return resource()->allocate(nbytes,
   alignment);.

.SH Parameters

   nbytes    - the number of bytes to allocate
   alignment - the alignment to use

.SH Return value

   A pointer to the allocated storage.

.SH Notes

   This function was introduced for use with the fully-specialized allocator
   std::pmr::polymorphic_allocator<>, but it may be useful in any specialization.

   The return type is void* (rather than, e.g., std::byte*) to support conversion to an
   arbitrary pointer type U* by static_cast<U*>.

.SH Exceptions

   May throw any exceptions thrown by the call to resource()->allocate.

.SH See also

   allocate_object allocates raw memory suitable for an object or an array
   (C++20)         \fI(public member function)\fP
   new_object      allocates and constructs an object
   (C++20)         \fI(public member function)\fP
   allocate        allocate memory
                   \fI(public member function)\fP
   allocate        allocates uninitialized storage using the allocator
   \fB[static]\fP        \fI(public static member function of std::allocator_traits<Alloc>)\fP

   allocate        allocates memory
                   \fI(public member function of std::pmr::memory_resource)\fP
